---
title: "Blueprint Upload - Specify Details"
method: POST
path: "/api/v1/blueprints (COPY)"
---

# Blueprint Upload - Specify Details

`POST /api/v1/blueprints (COPY)`

## Request body

- object
  - `current_user_id` integer — Required. The ID value of an admin user in the authenticated Hover organization
  - `job` object
    - `name` string — Required. The name of the job.
    - `deliverable_id` integer — Required. The ID value of the desired deliverable, type 2, 3, or 8.
    - `file_attachments_attributes` object
      - object — Required. Denotes the name for the specific elevation being built.
        - `url` string, binary — Semi-required, this parameter or the `jobs[files]` is required. This parameter is used to reference files already hosted elsewhere (Dropbox, S3, etc.). This requires providing provider, url, filename, mimetype, and size for each file.
    - `files` object
      - string — Semi required, this or the `job[file_attachments_attributes][][url]` parameter are required. Use job[files][] parameter to upload local files directly using the file path like `@/path/to/file.pdf`. This is the recommended approach for most use cases.
    - `location_line_1` string — The first line of the job's address.
    - `location_line_2` string — The second line of the job's address.
    - `customer_name` string — The name of the customer.
    - `email_address` string — The email address of the user assigned to the job.
    - `customer_phone` string — The phone number of a customer.
    - `location_city` string — The city of the job's address.
    - `location_region` string — The two character state value.
    - `location_postal_code` integer — The postal code of the job's address
    - `external_identifier` string — A unique identifier generated by the client.
  - `workflow` string — Required. "specify_details" - Creates blueprint submission and jobs automatically based on specifications; using specify details requires providing job_attributes[name][], and job_attributes[deliverable_id][] param . No default.
  - `job_attributes` object
    - `name` object — Required. The name of the job.
      - string — Required. Denotes the name for the specific elevation being built.
    - `deliverable_id` object — Required. The ID value of the desired deliverable, type 2, 3, or 8.
      - string — Required. Denotes the deliverable type for the specific elevation being built.

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.net/hover/apis/hover-api-v3.md) · [All operations](https://skmtc.net/hover/apis/hover-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hover/hover-api-v3/versions/98ae3699d4c9/schema)